<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>Hello H5+</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.navigator">navigator</a></h1>
<p>navigator用于管理浏览器运行环境信息</p>
<h2>方法：</h2>
<ul>
<li>
<a href="#plus.navigator.closeSplashscreen">closeSplashscreen</a>: 关闭程序启动界面</li>
<li>
<a href="#plus.navigator.createShortcut">createShortcut</a>: 创建应用快捷方式</li>
<li>
<a href="#plus.navigator.isFullscreen">isFullscreen</a>: 判断应用当前是否全屏模式显示</li>
<li>
<a href="#plus.navigator.isLogs">isLogs</a>: 判断应用当前是否输出日志</li>
<li>
<a href="#plus.navigator.setFullscreen">setFullscreen</a>: 设置应用是否全屏显示</li>
<li>
<a href="#plus.navigator.setLogs">setLogs</a>: 设置应用是否输出日志</li>
<li>
<a href="#plus.navigator.setStatusBarBackground">setStatusBarBackground</a>: 设置系统状态栏背景颜色</li>
<li>
<a href="#plus.navigator.getStatusBarBackground">getStatusBarBackground</a>: 获取系统状态栏背景颜色</li>
<li>
<a href="#plus.navigator.setStatusBarStyle">setStatusBarStyle</a>: 设置系统状态栏样式</li>
<li>
<a href="#plus.navigator.getStatusBarStyle">getStatusBarStyle</a>: 获取系统状态栏样式</li>
<li>
<a href="#plus.navigator.getStatusbarHeight">getStatusbarHeight</a>: 获取系统状态栏高度</li>
<li>
<a href="#plus.navigator.isImmersedStatusbar">isImmersedStatusbar</a>: 判断当前是否为沉浸式状态栏模式</li>
<li>
<a href="#plus.navigator.setUserAgent">setUserAgent</a>: 设置userAgent值</li>
<li>
<a href="#plus.navigator.getUserAgent">getUserAgent</a>: 获取userAgent值</li>
<li>
<a href="#plus.navigator.setCookie">setCookie</a>: 设置Cookie值</li>
<li>
<a href="#plus.navigator.getCookie">getCookie</a>: 获取Cookie值</li>
<li>
<a href="#plus.navigator.removeAllCookie">removeAllCookie</a>: 删除应用所有Cookie值</li>
<li>
<a href="#plus.navigator.removeCookie">removeCookie</a>: 删除应用Cookie</li>
<li>
<a href="#plus.navigator.removeSessionCookie">removeSessionCookie</a>: 删除应用所有会话期Cookie值</li>
</ul>
<h2>对象：</h2>
<ul><li>
<a href="#plus.navigator.ShortcutOptions">ShortcutOptions</a>: JSON对象，创建应用快捷方式要设置的参数</li></ul>
<h2>回调方法：</h2>
<ul>
<li>
<a href="#plus.navigator.ShortcutSuccessCallback">ShortcutSuccessCallback</a>: 创建桌面快捷方式成功的回调函数</li>
<li>
<a href="#plus.navigator.NavigatorErrorCallback">NavigatorErrorCallback</a>: 操作错误回调函数接口</li>
</ul>
<h2>权限：</h2>
<p>permissions</p>
<pre class="prettyprint linenums">
"Navigator": {
	"description": "浏览器信息"
}
			</pre>
<h1><a name="plus.navigator.ShortcutOptions">ShortcutOptions</a></h1>
<p>JSON对象，创建应用快捷方式要设置的参数</p>
<h2>属性：</h2>
<ul>
<li>name: <em>(<font class="type">String</font>
	类型
)</em>快捷方式名称<br><p>
	如果未设置则使用应用的名称，manifest.json中name属性值。
						</p>
</li>
<li>icon: <em>(<font class="type">String</font>
	类型
)</em>快捷方式的图标<br><p>
	如果未设置则优先使用应用中指定的图标（manifest.json中icon节点下对应分辨率的图标），如未区配则使用应用的图标（仅在独立打包时），否则使用runtime提供的默认图标。
						</p>
</li>
<li>toast: <em>(<font class="type">String</font>
	类型
)</em>创建快捷方式后的提示信息<br><p>
	快捷方式创建成功后显示，默认提示内容为“"XXXX"已创建桌面快捷方式”，其中"XXXX"为程序的名称，如果不需要提示则设置此值为空字符串。
						</p>
</li>
<li>extra: <em>(<font class="type">JSON</font>
	类型
)</em>快捷方式的扩展参数<br><p>
	其中key和value值都必须是字符串类型。
						</p>
</li>
<li>classname: <em>(<font class="type">String</font>
	类型
)</em>要启动Activity类名<br><p>
	通常情况下不需要指定此值，仅在5+SDK集成时自定义Activity才用到。
						</p>
</li>
</ul>
<h1><a name="plus.navigator.ShortcutSuccessCallback">ShortcutSuccessCallback</a></h1>
<p>创建桌面快捷方式成功的回调函数</p>
<pre class="prettyprint linenums">
void onSuccess( Event event ){
	var sure=event.sure; // 是否确定创建桌面快捷方式成功
}
				</pre>
<h2>参数：</h2>
<ul><li>event: 
		<em>(
			<font class="type">Event</font>
			)
			必选 </em>创建桌面快捷方式返回的数据<br>
	在部分Launcher上无法确定是否创建桌面快捷方式成功，此时可通过event.sure（Boolean类型）获取是否确定创建成功。
						</li></ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<h1><a name="plus.navigator.NavigatorErrorCallback">NavigatorErrorCallback</a></h1>
<p>操作错误回调函数接口</p>
<pre class="prettyprint linenums">
function void onError( Exception error ) {
	// Error.
	var code = error.code; // 错误编码
	var message = error.message; // 错误描述信息
}
				</pre>
<h2>参数：</h2>
<ul><li>error: 
		<em>(
			<font class="type">Exception</font>
			)
			必选 </em>操作失败信息<br>
	可通过error.code（Number类型）获取错误编码；
	可通过error.message（String类型）获取错误描述信息。
						</li></ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<br><br>
</div></body>
</html>
